The 640 MEG Shareware Studio 2

home *** CD-ROM | disk | FTP | other *** search

/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / door / catlist.zip / CATLIST.MAN < prev next >

Wrap

Text File | 1992-11-21 | 22KB | 439 lines

╓──────────────────────────────────────────────────────────────╖ ║╓────────────────────────────────────────────────────────────╖║ ║║┌─────┐ ┌──────┐ ┌─────┐ ┌─┐ ┌───┐ ┌─────┐ ┌─────┐║║ ║║│ ┌─┐ │ │ ┌──┐ │ └─┐ ┌─┘ │ │ └┐ ┌┘ │ ┌───┘ └─┐ ┌─┘║║ ║║│ │ └─┘ │ └──┘ │ │ │ ┌────┐ │ │ │ │ │ └───┐ │ │ ║║ ║║│ │ ┌─┐ │ ┌──┐ │ │ │ └────┘ │ │ │ │ └───┐ │ │ │ ║║ ║║│ └─┘ │ │ │ │ │ │ │ │ └──┐ ┌┘ └┐ ┌───┘ │ │ │ ║║ ║║└─────┘ └─┘ └─┘ └─┘ └────┘ └───┘ └─────┘ └─┘ ║║ ║╙────────────────────────────────────────────────────────────╜║ ║ ║ ║ A WILDCAT! Specific BBS Listing Program ║ ║ Copyright 1992, PAROLE Software ║ ║ ALL RIGHTS RESERVED ║ ╙──────────────────────────────────────────────────────────────╜ Dennis N. Maidon The Parole Board BBS 311 Buffalo Rd Clayton, NC 27520 (919) 965-3600 -> Voice (919) 965-9885 -> FAX The Parole Board BBS (919) 965-4696 -> US Robotics Dual Standard Free Advice BBS (919) 934-1002 -> US Robotics HST -------------------------- CatList is a BBS Listing door written specifically for Wildcat! BBS 3.x and greater. With v2.1, CatList should support TriBBS and Spitfire. This is untested. I do not imply in any shape, form or fashion that CatList will operate on any other BBS software. CatList will maintain a BBS list for a specified number of days. At the end of that time, the user that listed the BBS will receive a notice for 10 days informing him/her that the listing has expired and must be updated. On the eleventh day if the user has not updated the listing, it will be deleted from the database. CatList notifies the user that the listing was deleted. All notifications are sent using the USERxxx.BBS files which WildCat! sends to the individual user when they logon. Once this file is sent, WC! then deletes the file and logs it to the Activity.log. CatList supports COMs 1-4 only. It will also support COMs 5-8 with the addition of a FOSSIL driver. Only the user that originally listed a BBS will be able to Edit/Update or Delete that listing. You as the sysOp have the ability to E/U/D any listing in the database. The door should be easy enough to set up on its own, particularly if you're familiar with door operation under Wildcat! If you do have any problems, you can reach me on The Parole Board BBS or you can call me voice. REGISTERED OPTIONS: Once registered, you may set the Listing Age (Line #7 of the CFG file) to any number of days. Until registration, it is locked at 14 days. I do not like 'crippling' or 'handicapping' one of my programs but on my older doors, there are more un-registered users using them than registered. Registered SysOps also have the ability to use HEADER.DAT and TAIL.DAT files. These are ASCii text files that are added to the TEXT file that is created by CatList. You may use them for any reason that you desire. The HEADER.DAT is written to the text file just after the Copyright Info and before the body of the listings. The TAIL.DAT is written just after the body of the listings and before the credits. The files must be named "HEADER.DAT" & "TAIL.DAT". Registered owners that would like to use POSTMASTER (Copyright 1992, Dave Cody & BoardWalk Software) have the option of setting Line 12 of the CFG file to "Y". CatList will then create two files named "CATLIST.EXP" and "CATLIST.DEL" in the WC! home directory that you specified on line 10 of the CFG file. CATLIST.EXP contains the names of the users that have EXPIRED listings. The CATLIST.DEL contains the names of users with listings that have been deleted. These files are ONLY created once each day when the maintenance is performed. You may want to add a couple of lines to your DOORx.BAT to test for these files and have POSTMASTER work on them. CatList is fully functional other than these options. SUPPORT: Support for CatList is available from several sources. Messages may be left on The Parole Board BBS in the "PAROLE Software" conference or the Mustang! BBS in the "PRIVATE" conference. If you feel that a message is not satisfactory you may call me voice. (919) 965-3600 Please call before 9:30pm EST as I am an early riser and need to get my "beauty sleep". UPDATES: Updates are FREE to registered users and may be downloaded from The Parole Board BBS, Mustang! BBS and various other BBS systems. Once registered, CatList updates are free for life. If you wish an update on disk, send $3 to the address listed above and specify the disk size. There is a special release that is compiled with 286 specific code. It will not operate on an XT. It is a slightly smaller, faster EXE program. It is available of TPB as CLIST286.ZIP. It will automatically be shipped to register users in their disk set. Anyone may call and download it from the BBS. With the release of CatList 2.0, there is now a 386/486 specific release. The file name is CLIST386.BBS If you are in a hurry and do not want to take the time to logon, enter " PAROLE SOFTWARE NOW! " at the name prompt. It will give you access to the PAROLE Software file & support areas. Don't forget the "!" on "NOW". LEGALITIES __________ THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT WARRANTY, EXPRESSED, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY. DISTRIBUTION ____________ You may make this file available for downloading from your BBS or you may upload it to any BBS of your choice, provided that you do not make any changes to the contents of the archive (ZIP file). The archive and its individual contents may not be used by any service that charges any money whatsoever, without the written permission of the author. This ZIP file was created using the -AV function of PKZIP. If my AV is missing then this file may not be complete or has been tampered with. Complete and current editions of this program are always available for D/L on The Parole Board BBS. If the -AV is missing please complain to your sysop to stop the practice of removing AV's as this is your assurance from the programmer that the file is complete and virus free. INSTALLATION: Installation of CatList is an easy straightforward operation. You will need to create a directory to hold the CatList files. For simplicity, we will use the directory "C:\DOOR\CATLIST" in this documentation. Once you have created "\CATLIST", unZIP the CATLISTx.ZIP archive into that directory. You should then create a sub directory called "C:\DOOR\CATLIST\SCREENS". UnZIP the file "SCREENS.ZIP" into this sub-directory. SCREENS.ZIP should contain the following files: instruct.ans ─┐ User Instructions instruct.asc ─┘ menu.ans ─┐ menu.asc │ menu2.ans │ Main Menu menu2.asc │ menunew.ans │ menunew.asc ─┘ vscreen.ans ─┐ View system Stats Screen vscreen.asc ─┘ welcome.ans ─┐ Opening Welcome Screen welcome.asc ─┘ Any of these screens may be modified by the user but with some restrictions. The MENU.xxx, VSCREEN.xxx, and WELCOME.xxx screens must remain the same physical size since some of the info on them is hard coded in the CATLIST.EXE program. MSGIMP.ZIP contains sample .IMP files that you may modify to suit your individual tastes. Place these files where you normally place your .IMP files. This should be in your \WC30\MSG directory. The archive should contain the files "DELETE.IMP" and "EXPIRE.IMP". You will then need to edit the CATLIST.CFG file(s) to suit your individual WildCat! setup. You MUST use an ASCii editor to edit the CFG file at all times. Some word processors leave hidden control codes that could cause CatList to die a horrible and ugly death. The CATLIST.CFG file must contain 15 lines. Make sure that the lines in the CFG file that require a "^" switch have them. If you get an "Overflow error" or and "Illegal function call" then you have probably left one of the switches off. C:\WC30\WCWORK\NODE1\USERINFO.DAT <- Path to User file The Parole Board BBS <- BBS Name Dennis <- SysOp's first name Maidon <- SysOp's last name 12345 <- Registration Serial number 100 <- Min. Sec level to access door 260 <- Min Sec lev to Add listings 30 <- Number of days to maintain listing E:\TEXT\TPB-LIST.TXT^L <- Path to create text file and switch to determin the ltype of text file you want created. "^S" = Short Listing "^L" = Long Listing One of these switches *MUST* be present. C:\WC30\BULL\BULL35.BBS^Y <- Path to create COLOR bulletin & @pause@ switch C:\WC30\ <- Your HOME dir - ACTIVITY.xxx log C:\WC30\DISP <- Path to your display files Y <- (Y/N) Create files needed by POSTMASTER This option is only available to registered users but, this line must still be included in the CFG file. C:\WC30\DISP\GOODBYE.SCR^Y <- REGISTERED USERS ONLY FEATURE This line *MUST* be included in the CFG file whether you have registered CatList or not. CatList will now create a special color file that contains a specified number of listings from the database. I've had several request this feature so thast they may use it as a GOODBYE.BBS screen. If you want to disable this feature, place "[N]" on this line. If it is disabled, you may leave off the next line. The "^Y" will append a @pause@ to the special file. If yu do not want the pause, add "^N" to this line. One of these switches *MUST* be used if you do not disable the special file creation. 5 <- Number of listings in the Special file. If you've disabled the feature, you may leave this line out of the CFG file. Line 1 This is where CatList will look to find USERINFO.DAT. It MUST always point to the NODEx directory and NOT the \WC30 directory. DOOR.SYS will also work here but, I strongly recommend that you use USERINFO.DAT. Line 2 Your BBS name Line 3 Your First Name or the name you go by on the BBS (DO NOT use "SYSOP") Line 4 Your last name Line 5 When you register CatList you will be given a serial number. Place it on this line. Until then, you may put any number you desire here or leave it blank. Line 6 This is the minimum security level that you will allow to enter the door. DO NOT use the Security Name In makewild. Always use the Menu Access number. ┌──────────── MISCELLANEOUS ────────────┐ │ Menu access level 150 │<- Use this Number from the │ Menu display set 6 │ EDIT PROFILE SCREEN in │ Daily time limit 120 │ MAKEWILD. The cotton-picker │ Maximum logon time 60 │ won't work if you use the │ Maximum up/down ratio 50 │ Security Profile NAME. │ Maximum daily downloads 15 │ Trust Me, I've been there. Line 7 This is the minimus security level that may Add, Edit, Delete or Update listings. Same procedure as Line 6 Line 8 This is the number of days that a BBS listing will remain current. If you specify "45" here, all listing will remain valid for 45 days. At that time a notice will be sent to the LISTER that his listing has expired and that it will be deleted in 10 days. He will receive a notice each day for the 10 days. On the eleventh day, if the listing has not been updated, it will be deleted from the database. There is no way to recover the listing once it has been deleted. Users are notified by using the "USERxxxx.BBS" files in the Display directory. These files are deleted by Wildcat! once they have been sent to the user. The first person to enter the door each day causes the program to run the maintenance and update routines. Line 9 This line contain the path and name of the text file that you want CatList to create. This file contains no color codes and is paginated for a printer. This file is similar to the WCLIST.TXT file that the List door on Mustang! BBS creates. <G> You may also specify the type of listing you want created. "^S" = Short Listing (no description) "^L" = Long listing (full description) Line 10 This is the path and name of the COLOR bulletin that you want created. This bulletin is created using WC!3.x color codes and MUST have a ".BBS" filename extension. You may also prefer a HELLOx.BBS screen though the file could get a bit large in due time. You can also set the default for the @pause@ at the end of the bulletin. At the end of the bulletin use a "^" as the spacer and place either a "Y" or "N". One of them *MUST* be there for the program to work properly. Line 11 Path where CatList will find you ACTIVITY.xxx files. This is your Wildcat! home directory. CatList writes to the individual Activity logs so that you can keep tabs on what happens in the door. Line 12 This is the path to your Display directory. Catlist will write the USERxxxx.BBS file in this directory. Line 13 (Y/N) If this line is set to "Y" then Catlist will create the CATLIST.EXP & CATLIST.DEL files that are needed by POSTMASTER. This option is only available to registered users but, this line must still be included in the CFG file. Line 14 REGISTERED USERS! This line must be included in the CFG file for CatList to operate. If you want to disable it, place a "[N]" on this line. CatList willnow create a color display file with only a specified number of listings from the database. The number of listings in the file is controlled by line 15. "^Y" = @pause@ "^N" = no pause Line 15 Number of listings to be included in the Speciual file on line 14. Make sure that all your CFG files contain 15 lines. If you are operating a Multi-Node setup, you must have a separate CFG file for each node. Each CFG file mus also have unique name such as: BBS1.CFG BBS2.CFG BBS3.CFG --------------- NOTE: You may now use one (1) CFG file for multi-node by using the environment variables. When specifying the location of the system file on line 1 of the doors .CFG file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%, and %wcnodeid%. Some examples: PCBoard: USERS.SYS in C:\PCB - %pcbdrive%%pcbdir%\USERS.SYS USERS.SYS in C:\PCB\NODE1 - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS Wildcat!: USERINFO.DAT in C:\WC30\WCWORK\NODE1 - C:\WC30\WCWORK\NODE%WCNODEID% Non-PCBoard systems may use the PCB environment variables by setting them in either AUTOEXEC.BAT or in the batch that runs the door. For example: SET PCBDRIVE=C: SET PCBDIR=\BBSDIR SET PCBNODE=1 -------------- Create the CFG file(s) for you particular BBS. You will also need a DOORx.BAT to run the door. This one is simple. @ECHO OFF CD \DOOR\CATLIST CATLIST BBS.CFG /5 ──┬─ ┌──────────────┘ └ If you are running non-Standard Com ports on your BBS, you will need to pass the proper IRQ to the door. It doesn't hurt to pass the IRQ even if they are standard. If a user enters the door and it just sits there acting sort of stupid, it's probably looking for the correct IRQ. Always pass it on the command line and there will be no question. Some networks have a problem using the "/" symbol. CatList will now accept an asterisk "*" in place of the "/". You may also use the environment variable in the DOORx.BAT file to pass info to the door. CATLIST BBS%WCNODEID%.CFG /%WCIRQID% Make sure you DO have the variables set if you use this method. NOTE: CatList supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ number after the configuration filename. Let's assume your Door is called FOOBAR and you want to use COM1 and IRQ5. The command line passed to your Door would be: FOOBAR FOOBAR.CFG /5 FOOBAR FOOBAR.CFG *5 The /5 tells CatList to use IRQ5 rather than the standard IRQ4 that is normally used with COM1. No /x parameter is needed for the standard IRQ's. CatList supports IRQs 1 - 15. Fossil Driver Support --------------------- CatList supports the use of Fossil drivers. To tell your Door to use the Fossil driver instead of the standard COM ports, just put /FD on the command line when running the door. For example: MYDOOR MYDOOR.CFG /FD MYDOOR MYDOOR.CFG *FD indicates that a Fossil driver is present and should be used. If no Fossil driver is detected, CatList will print a message to that effect and exit the door gracefully. If you have WC! set up to TERMINATE on Doors, you will need to add a line to reload the BBS. I'm not sure about the exact way this is set up since I do not use this method. Check your WC! Manual. Wildcat! will pick up the [G]oodbye from the door as a normal logoff. It is possible that Livcat! will see this as a Drop Carrier and not pass it to WC! as a normal logoff. No damage is done. CREDITS: Wildcat! BBS is Copyright 1985-1992, Mustang Software Inc. PostMaster is Copyright 1992, Dave Cody and BoardWalk Software CatList was written using the DoorFrame Door module for MicroSoft's Visual Basic for MS-DOS, Professional Version. DoorFrame is Copyright 1990-1992, Ted Freeman Visual Basic for MS-DOS is Copyrighted by Microsoft Corporation. The ßeta Team [W]ho's Who: Mike Shockley Shock Treatment Garland, TX (214) 495-5980 Lee Fisher The LOST BBS Overland Pk., KS (913) 642-0349 Steve Sambor Land of the Unicorns Bronxville, NY (914) 961-0399 Craig Dunstan TranScan BBS Topeka, KS (913) 266-0781 Ned Attayek Free Advice BBS Smithfield, NC (919) 934-1002 Herb Dunn The Dew Drop Inn Bakersfield, CA (805) 322-5587 Tom Lamere The Petting Zoo Phoenix, AZ (602) 992-0019 Alan Bennett Terminal Entry Rockingham, NC (919) 895-0368 Without the time and effort that was spent by the preceding BETA team members, CatList would not have been possible. Also, a special thanks to all of you that have called with suggestions for CatList.